The following information is discussed:
This section provides an overview of the menu commands in the CodeWarrior IDE.
There are several menus in the IDE's menu bar:
In Windows, the File Menu, Edit Menu, Search Menu, Project Menu,
Debug Menu, Window Menu, and Help Menu are visible at all times.
In the Mac OS, the Apple Menu (Mac OS), File Menu, Edit Menu, Search Menu, Project Menu, Debug Menu, Window Menu, and Help Menu are visible at all times. If you activate ToolServer via the IDE Extras preference panel, then the Tools Menu (Mac OS) is also visible at all times.
The Version Control System (VCS) Menu is displayed only if you have installed and configured your CodeWarrior product to work with a compatible revision control system that you purchased separately. To learn more about revision control systems, and how to use them with CodeWarrior, refer to the documentation that came with the additional revision control software.
The Data Menu, Browser Menu, and Layout Menu are displayed when a window that can use their respective commands is present on the screen.
The Tools Menu (Mac OS) appears if ToolServer is active. The Scripts Menu (Mac OS) and Editor Extensions Menu (Mac OS) are displayed when you set the correct preferences in the Preferences window. Refer to "IDE Extras" on page 254 for more information on how to do this.
Many menu commands can also have button equivalents on the toolbars. To learn more about how to customize the toolbars, refer to "Customizing the IDE" on page 289.
Creates a new editable text file.
To learn more about this command, refer to "Creating a New File" on page 107 for more information.
Opens the New dialog box. This dialog box helps you create various items in the CodeWarrior IDE.
Allows you to open an existing file.
To learn more about this command, refer to "Opening Files from the File Menu" on page 108.
To learn more about this command, refer to "Opening Files from the File Menu" on page 108.
Opens an existing file, searching the current access paths as specified in the Access Paths panel of the Target Settings window.
See "Opening Files from an Editor Window" on page 113 for more information.
See "Opening Files from an Editor Window" on page 113 for more information.
See "Closing a File" on page 121 for more information.
To learn how to close all open editor windows, refer to "Closing All Files" on page 123.
To learn more about this topic, refer to "Closing All Files" on page 123.
Saves the contents of the active window to disk.
For more information on this topic, refer to "Saving one file" on page 115.
Saves all editor files that are currently open.
For more information on this topic, refer to "Saving all files" on page 116.
Saves the contents of the active window to disk under another name of your choosing.
For more information, see "Renaming and saving a file" on page 116.
For more information, see "Backing up files" on page 118.
Reverts the active editor window to its last saved version.
To learn more about reverting a file, see "Reverting to a Previously-Saved File" on page 125.
Imports components from another catalog for use with the current catalog.
For more information about this command, see "Component Catalog Toolbar" on page 532.
Closes the current catalog and removes it from the Component Catalog window and the Component Palette.
For more information about this command, see "Component Catalog Toolbar" on page 532.
For more information, see "Importing and Exporting a Project" on page 102.
To learn more, see "Importing and Exporting a Project" on page 102.
Sets the options used when printing files from the CodeWarrior IDE.
For more information about this command, see "Setting Print Options" on page 123.
Sets the options used when printing files from the CodeWarrior IDE.
For more information about this command, see "Setting Print Options" on page 123.
Prints files from the CodeWarrior IDE on your printer.
For more information on printing files, see "Printing a Window" on page 124, or read the documentation that came with your printer.
Exits the CodeWarrior IDE immediately, provided one of the following conditions has been met:
Quits the CodeWarrior IDE immediately, provided one of the following conditions has been met:
To learn more about this topic, refer to "Undoing the last edit" on page 152, and "Undoing and redoing multiple edits" on page 152.
If you don't have Use multiple undo turned on in the Editor Settings preference panel, the Undo command toggles between Undo and Redo. To learn more about how to configure this option, refer to "Editor Settings" on page 269.
If you have Use multiple undo turned on in the Editor Settings preference panel, you have more flexibility with regard to Undo and Redo operations. Choose Undo
multiple times to undo multiple actions. Choose Redo
multiple times to redo multiple actions.
To learn more about undo operations, refer to "Undoing the last edit" on page 152, and "Undoing and redoing multiple edits" on page 152.
To learn about how to configure multiple undo, refer to "Editor Settings" on page 269.
Pastes the contents of the system Clipboard into the active Editor window.
If the active window is the Message Window, the Paste
command is dimmed and cannot be executed.
To learn more about selecting text, refer to "Selecting Text" on page 148.
Selects the text enclosed in either parentheses (), brackets [], or braces {}. For a complete procedure on how to use this command and how to balance while typing, consult "Balancing Punctuation" on page 150.
To learn more about this feature, refer to "Shifting Text Left and Right" on page 151.
Shifts the selected source code one tab size to the right.
To learn more about this feature, refer to "Shifting Text Left and Right" on page 151.
To learn about configuring the online reference database application and the Find Reference Using pop-up menu, refer to "IDE Extras" on page 254.
Use this command to change the global preferences for the CodeWarrior IDE.
To learn more about configuring preferences, refer to "Choosing Preferences" on page 252.
To learn more about the Settings window, refer to "Choosing Target Settings" on page 318. To learn how to change the current build target, refer to "Set Default Target" on page 618.
This menu command displays the Version Control System options panel. To learn more about this panel, refer to the section of this manual entitled "Using CodeWarrior IDE with Version Control Systems" on page 581
This command displays the Customize IDE Commands window.
To learn more about the Find window and its capabilities, refer to "Guided Tour of the Find Dialog Box" on page 165.
Finds the next occurrence of the Find text box string in the active window. This is an alternative to clicking the Find button in the Find dialog box.
To learn more about this feature, refer to "Finding Search Text" on page 178.
Find Previous
operates the same way as Find Next, except that it finds the previous occurrence of the Find text box string.
To learn more about this feature, refer to "Finding Search Text" on page 178.
Finds the next occurrence of the Find text box string in the next file listed in the Multi-File Search portion of the Find window (as exposed by the Multi-File Search Disclosure triangle in the Find window). This is an alternative to using the Find window. If the Multi-File Search button is not enabled as shown in Figure 6.3 on page 171, this command is dimmed.
To learn more about this feature, refer to "Finding and Replacing Text in Multiple Files" on page 185.
This command operates in much the same way as Find in Next File
. The Find in Previous File
command begins at the end of the previous file in the file list and searches for the next occurrence of the Find text box string.
To learn more about this feature, refer to "Finding and Replacing Text in Multiple Files" on page 185.
This command copies the selected text in the active window into the Find text box, making it the search target string. This is an alternative to copying text and pasting it into the Find window.
To learn how to select text, refer to "Selecting Text" on page 148.
This command copies the selected text in the active window into the Replace text box, making it the replacement string. This is an alternative to selecting the string and copying it into the Find window.
To learn more about replacing text, refer to "Replacing Found Text" on page 182.
Finds the next occurrence of the selected text in the active text editor window.
To learn more about this feature, refer to "Finding Search Text" on page 178.
This command finds the previous occurrence of the selected text in the active text editor window.
To learn more about this feature, refer to "Finding Search Text" on page 178.
To learn how to select text, refer to "Selecting Text" on page 148.
This command replaces the selected text in the active window with the text string in the Replace text box of the Find window. If no text is selected in the active editor window, this command is dimmed.
This command is useful if you wish to replace one instance of a text string without having to open the Find window. For example, say that you have just replaced all the occurrences of the variable "icount" with "jcount". While scrolling through your source code, you notice one instance of the variable "icount" is misspelled as "icont". To replace this variable with "jcount", select "icont" and choose the Replace
command from the Search Menu.
To learn more about replacing text, refer to "Replacing Found Text" on page 182.
To learn how to select text, refer to "Selecting Text" on page 148.
This command replaces the selected text with the string in the Replace text box of the Find window, and then performs a Find Next. If no text is selected in the active editor window and there is no text in the Find text box string field of the Find window, this command is dimmed.
To learn more about replacing text, refer to "Replacing Found Text" on page 182.
To learn how to select text, refer to "Selecting Text" on page 148.
This command operates the same way as Replace & Find Next except that it performs a Find Previous after replacing text.
If the CodeWarrior IDE finds more than one definition, a Message window appears warning you of multiple definitions. For more information on the Message window, consult "Using the Message Window" on page 376.
If no definition is found, a system beep sounds.
Searching takes place in QuickHelp, QuickView, THINK Reference version 2.x, or Toolbox Assistant.
If no definition is found, a system beep sounds.
For more information about choosing an online reference database, refer to "IDE Extras" on page 254.
To learn more about online databases, refer to "Online References" on page 158.
If no definition is found, a system beep sounds.
For more information about choosing an online reference database, refer to "IDE Extras" on page 254.
To learn more about online databases, refer to "Online References" on page 158.
This command returns you to the previous view in the Browser.
To learn more about this feature, refer to "Go Back and Go Forward" on page 242.
This command moves you to the next view in the Browser (after you have used the Go Back command to return to a previous view).
Refer to "Go Back and Go Forward" on page 242 for more information.
For more information about this feature, refer to "Going to a Particular Line" on page 157.
Opens a dialog box to choose two files or folders to compare and merge. After choosing files to compare, a file comparison window appears, showing differences between the two files. If two folders are compared, the differences between the folders are shown in the Compare Folders window. For more information, see "Comparing and Merging Files & Folders" on page 125.
Reverses the action of an Apply Difference
command in a file comparison window.
This command adds the file in the active Editor window to the open project.
To learn more about this feature, refer to "Using the Add Window command" on page 84.
This menu command adds files to the Project window.
To learn more about this feature, refer to "Using the Add Files command" on page 79.
For more information about creating groups, refer to "Creating Groups" on page 86.
For more information about creating targets, refer to "Working with Complex Projects" on page 90.
For more information about managing segments, refer to "Managing Files in a Project" on page 74.
This menu command removes the currently selected items from the Project window. To learn more about removing items from the Project window, refer to "Managing Files in a Project" on page 74.
To abort this command at any time, press Esc (Windows) or Command-Period (Mac OS).
If one or more errors are detected, the Message window appears. For information on how to correct compiler errors, consult "Correcting Compiler Errors and Warnings" on page 379.
To learn more about this command, refer to "Preprocessing Source Code" on page 372.
This command precompiles the text file in the active Editor window into a precompiled header file.
To learn more about this topic, refer to "Using Precompiled or Preprocessed Headers" on page 365.
To learn more about this topic, refer to "Compiling and Linking a Project" on page 357.
To learn more about this feature, refer to "Disassembling Source Code" on page 373.
This command updates the open project by compiling all of its modified and "touched" files.
To learn more about this topic, refer to "Updating a Project" on page 360.
To learn more about this topic, refer to "Making a Project" on page 360.
This command halts the build currently in progress.
To learn more about this topic, refer to "Compiling and Linking a Project" on page 357.
This command removes all compiled source code binaries from the open project. The numbers in the Code column and Data column of each file are reset to zero.
To learn more about this topic, refer to "Removing Object Code" on page 363.
To learn more about this topic, refer to "Removing Object Code" on page 363.
If the Save project entries using relative paths setting is enabled the IDE does not reset the relative path information stored with each project entry, so re-searching for files will find the source files in the same location (the exception is if the file no longer exists in the old location). In this case the IDE will only re-search for header files. To force the IDE to also re-search for source files, you must first select Reset Project Entry Paths.
This command resets the location information stored with each project entry when the Save project entries using relative paths setting is enabled. The next time the project entries are accessed, the IDE will re-search for the project entries in the access paths. This command does nothing if the Save Project Entries Using Relative Paths setting is disabled.
To learn more about this topic, refer to "Synchronizing modification dates" on page 90.
When you choose the Enable Debugger command, the Run command changes to Debug
and lets the debugger launch and debug your project. When you choose the Disable Debugger command, the Run
command runs your project normally.
To learn more about this topic, refer to "Controlling Debugging in a Project" on page 103.
To learn more about this topic, refer to "Controlling Debugging in a Project" on page 103.
This command compiles, links, creates a stand-alone application, and launches that application.
If the project type is set as a library or a shared library, then the Run
command is dimmed.
To learn more about this topic, refer to "Running a Project" on page 361.
This menu command selects which project is the default project. To learn more about what a default project is, refer to "Choosing a Default Project" on page 73.
Permanently terminates execution of the target program and returns control to the IDE.
Restarts the debugging session.
Resets the program and returns control to the IDE.
Resets the program and also resets the hardware before returning control to the IDE.
Executes a single statement, stepping over function calls.
Executes a single statement, stepping into function calls.
Executes the remainder of the current function until it exits to its caller.
Temporarily suspends execution of the target program and returns control to the debugger.
Clears all breakpoints in all source-code files belonging to the target program.
The watchpoint is indicated by an underline. You can configure the color of this underline using the Display Settings preference panel in the IDE Preferences window. For more information, refer to "Display Settings" on page 279.
The watchpoint is indicated by an underline. You can configure the color of this underline using the Display Settings preference panel in the IDE Preferences window. For more information, refer to "Display Settings" on page 279.
Enabled watchpoints are indicated by an underline for the selected variable or range of memory. Disabled watchpoints do not have the underline. The underline's color can be configured in the Display Settings preference panel of the IDE Preference window. See "Display Settings" on page 279. for more information.
Enabled watchpoints are indicated by an underline for the selected variable or range of memory. Disabled watchpoints do not have the underline. The underline's color can be configured in the Display Settings preference panel of the IDE Preference window. See "Display Settings" on page 279. for more information.
Clears all watchpoints in the current program.
Causes the debugger to break at __throw() every time a C++ exception occurs.
This menu item causes the Java Exceptions submenu to appear. To learn more about this submenu, refer to "Java Exceptions Submenu" on page 633.
Gives control to an external debugger that you may have installed on your computer.
The low-level Macintosh ROM Monitor program and MacsBug are two examples of external debuggers.
Creates a new entry in the Expressions window, prompting you to enter a new expression.
Displays a selected variable as a value of a specified data type.
Creates a separate window to display a selected variable.
Creates a separate window to display a selected array.
Displays the contents of memory as a hexadecimal/ASCII character dump.
Displays the memory a selected variable occupies or a selected register points to.
Displays the selected variable in its default format based on the variable type.
Displays the selected variable as a signed decimal value.
Displays the selected variable as an unsigned decimal value.
Displays the selected variable as a hexadecimal value.
Displays the selected variable as a character value.
Displays the selected variable as a C character string.
Displays the selected variable as a Pascal character string.
Displays the selected variable as a Unicode character string.
Displays the selected variable as a floating-point value.
Displays the selected variable as an enumeration.
Displays the selected variable as a numerical value of type Fixed
.
Displays the selected variable as a numerical value of type Fract
.
Displays a dialog box to help you create a new class for your project.
Displays a dialog box to help you create a new member function for your project.
Displays a dialog box to help you create a new data member for your project.
Displays a dialog box to help you create a new property for a selected class in your project.
Displays a dialog box to help you create a new method for a selected class in your project.
Displays a dialog box to help you create a new event set for a selected class in your project.
Displays a dialog box to help you create a new event for a selected class in your project.
This command arranges all the Editor windows in a single row.
This command is disabled when the active window is the Project window or Message window.
ToolServer Worksheets also disable this command.
Minimizes the currently active window.
Collapses the currently active window.
Restores a window to its original size.
Expands a window to its original size.
To learn more about this command, refer to, "Saving Editor Window Settings" on page 144, or "Saving a Default Browser" on page 247.
This menu item causes the Toolbar submenu to appear. To learn more about this submenu, refer to "Toolbar Submenu" on page 633.
This command displays the Browser Contents Window. This menu command is dimmed when the Browser is not activated.
To learn more about this feature, refer to "Contents Window" on page 213. To learn how to activate the Browser, refer to "Activating the Browser" on page 205.
This command displays the Browser's Multi-Class Hierarchy Window. This menu command is dimmed when the Browser is not activated.
To learn more about this feature, refer to "Multi-Class Hierarchy Window" on page 221.
To learn how to activate the Browser, refer to "Activating the Browser" on page 205.
This command displays the Browser's Browser Window. This menu command is dimmed when the Browser is not activated.
To learn more about this feature, refer to "Browser Window" on page 214.
To learn how to activate the Browser, refer to "Activating the Browser" on page 205.
This menu command displays the progress window for builds, as shown in Figure 10.1 on page 358.
This command displays the Errors and Warnings window.
To learn more about this window, refer to "Guided Tour of the Message Window" on page 373. Also, refer to "Using Batch Searches" on page 184.
To learn more about this command's window, refer to "Guided Tour of the Project Window" on page 42.
Displays the Processes window.
Displays the Expressions window.
Displays the Breakpoints window.
Displays the Watchpoints window.
Displays the Component Catalog window for use with RAD projects.
Displays the Component Palette for use with RAD projects.
Displays the Object Inspector for use with RAD projects.
A file whose modifications have not been saved is underlined.
Combines selected objects so that they move together as a group.
Separates a selected group so you can move each object independently.
Moves the selected objects so that they are displayed behind all other objects.
Moves the selected objects so that they are displayed in front of all other objects.
When checked, displays the graphical grid in the layout window.
When checked, the Layout editor automatically aligns objects with the graphical grid.
The Version Control System (VCS) menu, shown in Figure 17.1, may appear in the menu bar of your CodeWarrior IDE if you have purchased the MW Visual SourceSafe for Macintosh Version Control System (available separately) for use with the CodeWarrior IDE.
Displays help for using the CodeWarrior.
Displays step-by-step help topics.
Displays a list of vocabulary terms.
Displays help for using the IDE.
Displays help for using the debugger.
Displays help for referencing IDE errors.
Displays help for the C/C++ compilers.
Displays help for the Metrowerks Standard Library (MSL) for C.
Displays help for the Metrowerks Standard Library (MSL) for C++.
Displays other information specific to your CodeWarrior product.
Displays the Metrowerks About Box.
The Debug Menu has another submenu under it for the Break on Java Exceptions command. The Java Exceptions submenu contains options that tell the debugger what to do when Java exceptions occur. This command is available when you are working with Java source code, and is dimmed for all other source code.
When you select this menu command, the debugger will not break when exceptions occur.
The Window Menu has another submenu under it for the Toolbar command. The Toolbar submenu contains all the commands used to customize the toolbars that appear in CodeWarrior IDE windows.
To learn more about how to customize the toolbars, read the information in "Customizing the IDE" on page 289.
Use the Reset Window Toolbar command to cause all the default icons to come back.
The Apple menu contains one IDE-related item.
Choose this item to see the way-cool About Box.
To learn more about ToolServer, refer to Targeting Mac OS.
This command brings up the Commando dialog box, as shown in Figure 17.2. To learn more about Commando, refer to Targeting Mac OS.
The Script menu, shown in Figure 17.3, contains a list of the AppleScripts in the (Scripts)
folder.
This menu will only appear if the Use Script Menu setting is turned on in the IDE Extras preference panel. Also, this menu will only be shown if the (Scripts)
folder is present in your Metrowerks CodeWarrior folder. To learn more about how to configure the appropriate preferences, refer to "IDE Extras" on page 254.
To learn more about AppleScripts and scripting the CodeWarrior IDE, refer to Targeting Mac OS.
The Editor Extensions menu (Figure 17.4) is similar to the Script Menu. If the Use BBEdit Extensions preference is enabled, a list of BBEdit extensions are added to the menu bar. You must have an alias or folder called (Editor Extensions)
, including the parentheses, in the same folder as the CodeWarrior IDE application. Place the editor extensions that you wish to use inside the (Editor Extensions)
folder. You can also place aliases of the editor extensions inside the (Editor Extensions)
folder.
To learn more about how to configure the appropriate preferences so this menu becomes visible, refer to "IDE Extras" on page 254.
For more information about BBEdit, refer to the documentation that came with the product.
The Info menu (Figure 17.5) is contains the following menu items:
Choose this item to see the Metrowerks CodeWarrior about box.
Choose this item to see the CodeWarrior Latitude about box.
This item launches a desk accessory which enables you to copy files and folders. From within the CodeWarrior IDE, you can copy files and folders between file systems or devices accessible from your Solaris environment. See "Copy Files Accessory" on page 659. for a detailed description of this accessory.
This facility allows you to mount volumes from within the CodeWarrior IDE. For more information on using this facility, refer to "File Systems Facility" on page 662.
Use this command to display the Keyboard Preferences dialog box where you can change the default modifier key mappings. To learn more about this settings panel, refer to "Keyboard Preferences Dialog Box" on page 667.
This section describes the default key bindings assigned to commands in the CodeWarrior IDE.
CodeWarrior does not assign default key bindings to all of the available commands, so their respective key-binding lists appear blank. You can assign key bindings to any command. For more information about key bindings, see "Customizing Key Bindings" on page 297.
The key-binding sections include:
Modifier keys are used in combination with other keys to generate key bindings. For instance, to execute the Ctrl/Command - N keyboard shortcut, you first press the Ctrl or Command modifier key, and while holding it down, press the N key on your keyboard. For Mac OS-, Solaris-, and Linux-hosted versions of the CodeWarrior IDE, symbols are used to represent modifier keys in menus as well as the Customize IDE Commands window. The legend in Table 17.1 describes how these symbols correspond to their associated names on Mac OS, Solaris, and Linux platforms.
Symbol
|
Mac OS
|
Solaris and Linux
|
---|---|---|
Table 17.2 contains the default key bindings for manipulating projects and files from within the CodeWarrior IDE.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|
Table 17.3 contains the default key bindings for the commands in the Edit menu of the CodeWarrior IDE.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|
Table 17.4 contains the default key bindings for the commands in the Search menu of the CodeWarrior IDE.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|
Table 17.5 contains the default key bindings for managing projects, controlling compilations, and much more.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|
Table 17.6 contains the default key bindings for handling commands on the Debug menu in the CodeWarrior IDE.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|
Table 17.7 contains the default key bindings for handling debugger variable displays in the IDE.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|
Table 17.8 contains the default key bindings for use with the class browser in the CodeWarrior IDE.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|
Table 17.9 contains the default key bindings for handling miscellaneous tasks in the CodeWarrior IDE.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|
Table 17.10 contains the default key bindings for handling Editor windows in the CodeWarrior IDE.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|
Table 17.11 contains the default key bindings for use with the CodeWarrior class browser.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|
Table 17.12 contains the default key bindings for use with the CodeWarrior RAD layout editor.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|
Table 17.13 contains the default key bindings for handling many common windows in the CodeWarrior IDE.
Command
|
Windows
|
Mac OS
|
Solaris and Linux
|
---|---|---|---|